Chunk 大小警告处理

构建时 chunk 超过阈值会显示警告，可调整阈值或优化分包策略。

默认警告阈值

默认 500KB，超过此值会显示警告：

JavaScript

(!) Some chunks are larger than 500 kB after minification.

调整警告阈值

JavaScript

export default defineConfig({
  build: {
    chunkSizeWarningLimit: 1000  // 调整为 1000KB
  }
})

禁用警告

JavaScript

export default defineConfig({
  build: {
    chunkSizeWarningLimit: Infinity  // 禁用警告
  }
})

注意：不建议禁用警告，大 chunk 影响加载性能。

优化分包解决警告

Bash

export default defineConfig({
  build: {
    rollupOptions: {
      output: {
        manualChunks(id) {
          // 大依赖单独分包
          if (id.includes('node_modules')) {
            if (id.includes('large-lib')) {
              return 'large-lib'
            }
            return 'vendor'
          }
        }
      }
    }
  }
})

分析大 chunk 原因

JavaScript

# 安装分析插件
npm add -D rollup-plugin-visualizer

text

import { visualizer } from 'rollup-plugin-visualizer'

export default defineConfig({
  plugins: [
    visualizer({
      filename: 'stats.html',
      open: true
    })
  ]
})

构建后打开 stats.html 可视化分析 chunk 组成。

警告处理策略

策略	操作	适用场景
调整阈值	chunkSizeWarningLimit	合理的大 chunk
优化分包	manualChunks	可拆分的大 chunk
禁用警告	Infinity	不推荐

chunk 大小影响因素

第三方依赖体积
业务代码数量
是否使用 Tree Shaking
压缩效果

要点总结

默认阈值 500KB
chunkSizeWarningLimit 调整阈值
推荐优化分包而非禁用警告
使用 visualizer 分析 chunk 组成